home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / program / 569 / devpac_1 / devpac1.txt next >
Text File  |  1991-02-07  |  4KB  |  92 lines
  1. ----------------------------------------------------------------------
  2.  
  3.                            DevpacST VERSION 1
  4.                            ------------------
  5.  
  6.                         Copyright (c) HiSoft 1987.
  7.  
  8.              Brought to you by ST Format Magazine and HiSoft
  9.  
  10. ----------------------------------------------------------------------
  11.  
  12. Introduction
  13. ------------
  14. ST Format, in collaboration with HiSoft, bring you HiSoft Devpac
  15. Version 1.... for free!! This text file is a short tutorial getting
  16. going with the two Devpac programs, GENST and MONST.
  17.  
  18. We chose Devpac over all the opposition because it is generally
  19. regarded by all the top programmers as THE development system on the ST
  20. and Amiga.
  21.  
  22.  
  23. Getting Started
  24. ---------------
  25. Devpac version 1 comes in two parts; the GENST assembler and MONST, the
  26. debugger. You can load both of these programs by clicking directly on
  27. their icons on the Desktop. MONST comes to you in two versions,
  28. MONST.PRG and MONST.TOS. MONST.PRG is the version that you'll probably
  29. use most of all and the rest of this text is based around that version.
  30.  
  31.  
  32. Using the GENST Assembler/Editor
  33. --------------------------------
  34.  
  35. GENST is the assembler part of the Devpac development system. From
  36. within this program you can write your code and assemble it. The Editor
  37. part of the program is just a standard text editor not unlike those
  38. you've probably used a thousand times before. You can enter, then edit
  39. your code using the cursor keys, backspace etc in the standard manner.
  40.  
  41. Once you've written your program you must next assemble it. This is
  42. achieved by selecting the ASSEMBLE option from the pull down menus.
  43. Once selected, a dialog box will pop up on the screen containing two
  44. fields: Binary filename and Listing.
  45.  
  46. BINARY FILENAME    :Entering a filename within this field will tell Devpac
  47.          where you would like the final, assembled program to be
  48.          written. For example, if you want your program to be
  49.          called 'TEST.PRG' and be written to drive B, you
  50.          would enter B:\TEST.PRG.
  51.  
  52.  
  53. LISTING        :Select one of the four buttons to determine where the
  54.          assembly listing is to be channelled to.
  55.  
  56. To actually run your program, you will have to exit GENST. Double click
  57. on the icon for your program and hopefully, it should run ok.
  58.  
  59.  
  60. Using the MONST Monitor/Debugger
  61. --------------------------------
  62. MONST is the Devpac monitor/debugger tool that is used to debug your
  63. programs to stop them dropping bombs on your desktop.
  64.  
  65. Once MONST is loaded, it will ask you for the filename of the program
  66. you wish to debug. For examples sake, lets say your program called
  67. TEST.PRG wasn't doing what you wanted it to do, you would therefore
  68. enter 'TEST.PRG' at this prompt. Devpac will then prompt you to enter a
  69. command line, just press <RETURN> twice and you will be magically
  70. transported to the MONST main screen.
  71.  
  72. If you take a look at the screen, you will notice that all sorts of
  73. useful information about the current state of the system is displayed,
  74. such as the values held in the 8 data registers (D0-D7), the 8 address
  75. registers (A0-A7), the status register (SR) and the program counter
  76. (PC).
  77.  
  78. From within MONST, you can step through the execution of your program
  79. and observe at a glance the effect of your program on the different
  80. registers. MONST is a powerful program and it would therefore be
  81. impossible for use to fully document it. Listed below is a short
  82. overview of the most important keys but for a more indepth look at
  83. MONST, you are advised to treat yourself to the full version.
  84.  
  85. MONST Key Controls Overview:
  86. ----------------------------
  87.     CTRL + Z  : Single Step - Executes the next opcode
  88.     CTRL + R  : Resume Execution - Takes you out of single step
  89.             mode and starts running the rest of your program.
  90.  
  91.     CTRL + C  : Exits from MONST and returns you to the Desktop
  92.